addOnBeaconListener

abstract fun addOnBeaconListener(@NonNull listener: OnBeaconListener)

Registers an OnBeaconListener to receive notifications about beacon proximity events.

This listener is invoked when the device enters or exits the range of a configured beacon (e.g., iBeacon, Eddystone). This can be used to trigger location-aware content or actions. The specifics of beacon detection (types, configuration) are managed by the player's beacon service.

Ensure removeOnBeaconListener is called when the listener is no longer required to prevent memory leaks.

Parameters

listener

The non-null OnBeaconListener instance to register.

See also

Throws

if listener is null.